Cordova JavaScript API এবং ডিভাইসের সাথে ইন্টারঅ্যাকশন

Cordova JavaScript API হল সেই API সেট যা ব্যবহার করে আপনি JavaScript কোড লিখে আপনার Cordova অ্যাপ্লিকেশন এর মাধ্যমে মোবাইল ডিভাইসের নেটিভ ফিচারগুলির সাথে ইন্টারঅ্যাক্ট করতে পারেন। Cordova এর মূল উদ্দেশ্য হলো, ওয়েব প্রযুক্তি ব্যবহার করে মোবাইল ডিভাইসের নেটিভ ফিচার অ্যাক্সেস করা, যেমন ক্যামেরা, GPS, ফোন কন্টাক্টস, স্টোরেজ ইত্যাদি।

Cordova JavaScript API এর মূল উপাদান

1. Device API
   Cordova অ্যাপ্লিকেশনটি মোবাইল ডিভাইসের ডেটা এবং ফিচার অ্যাক্সেস করতে সক্ষম। যেমন, ডিভাইসের হার্ডওয়্যার ফিচার, অপারেটিং সিস্টেম, আইডেন্টিফায়ার ইত্যাদি।

   • Device Information:
     আপনি ডিভাইসের বিভিন্ন তথ্য যেমন ডিভাইসের প্ল্যাটফর্ম (Android/iOS), মডেল, সংস্করণ ইত্যাদি অ্যাক্সেস করতে পারেন।

     var deviceInfo = {
         platform: device.platform,
         version: device.version,
         model: device.model,
         uuid: device.uuid
     };
     console.log(deviceInfo);

2. Camera API
   Cordova অ্যাপ্লিকেশন ক্যামেরা অ্যাক্সেস করতে পারে, যার মাধ্যমে আপনি ছবি তুলতে বা ভিডিও রেকর্ড করতে পারেন।

   • ক্যামেরা ব্যবহার:

     navigator.camera.getPicture(onSuccess, onError, {
         quality: 50,
         destinationType: Camera.DestinationType.FILE_URI
     });
     
     function onSuccess(imageURI) {
         var image = document.getElementById('myImage');
         image.src = imageURI;
     }
     
     function onError(message) {
         alert('Failed because: ' + message);
     }

3. Geolocation API
   Cordova অ্যাপ্লিকেশন মোবাইল ডিভাইসের GPS বা লোকেশন সেবা ব্যবহার করে ব্যবহারকারীর বর্তমান অবস্থান বা Latitude এবং Longitude পেতে পারে।

   • লোকেশন অ্যাক্সেস:

     navigator.geolocation.getCurrentPosition(onSuccess, onError);
     
     function onSuccess(position) {
         var lat = position.coords.latitude;
         var lon = position.coords.longitude;
         console.log("Latitude: " + lat + ", Longitude: " + lon);
     }
     
     function onError(error) {
         console.log('Error Code: ' + error.code + '\n' + 'Error Message: ' + error.message);
     }

4. Device Motion API
   Cordova ডিভাইসের Accelerometer এবং Gyroscope এর মাধ্যমে ডিভাইসের মুভমেন্ট ট্র্যাক করতে পারে। এর মাধ্যমে অ্যাপ্লিকেশন ডিভাইসের অবস্থান এবং গতি নির্ণয় করতে পারে।

   • Device motion:

     var options = { frequency: 100 }; // 100ms interval
     navigator.accelerometer.watchAcceleration(onSuccess, onError, options);
     
     function onSuccess(acceleration) {
         console.log("X: " + acceleration.x + ", Y: " + acceleration.y + ", Z: " + acceleration.z);
     }
     
     function onError(error) {
         console.log('Error: ' + error);
     }

5. Contacts API
   Cordova ডিভাইসের কন্টাক্ট লিস্টের অ্যাক্সেস প্রদান করে, যেখানে আপনি ডিভাইসের সেভ করা কন্টাক্ট তথ্য পেতে পারেন।

   • Contacts অ্যাক্সেস:

     var options = new ContactFindOptions();
     options.filter = ""; // Filter the contact list (optional)
     options.multiple = true;
     var fields = ["displayName", "phoneNumbers"];
     
     navigator.contacts.find(fields, onSuccess, onError, options);
     
     function onSuccess(contacts) {
         for (var i = 0; i < contacts.length; i++) {
             console.log(contacts[i].displayName);
         }
     }
     
     function onError(error) {
         console.log('Error retrieving contacts: ' + error);
     }

6. File API
   Cordova অ্যাপ্লিকেশন ডিভাইসের ফাইল সিস্টেমে অ্যাক্সেস করতে পারে, যার মাধ্যমে আপনি ফাইল তৈরি, পড়া, লেখার কাজ করতে পারেন।

   • File read/write:

     window.requestFileSystem(LocalFileSystem.PERSISTENT, 0, onSuccess, onError);
     
     function onSuccess(fileSystem) {
         fileSystem.root.getFile("myfile.txt", { create: true, exclusive: false }, onGetFileSuccess, onError);
     }
     
     function onGetFileSuccess(fileEntry) {
         fileEntry.createWriter(onCreateWriterSuccess, onError);
     }
     
     function onCreateWriterSuccess(writer) {
         writer.write("Hello Cordova!");
     }
     
     function onError(error) {
         console.log('Error: ' + error);
     }

7. Network Information API
   এই API ব্যবহার করে আপনি ডিভাইসের নেটওয়ার্ক স্টেট, যেমন WiFi বা Cellular কানেকশন অ্যাক্সেস করতে পারেন।

   • Network Status:

     var networkState = navigator.connection.type;
     console.log("Connection type: " + networkState);

Cordova API ব্যবহারের অন্যান্য গুরুত্বপূর্ণ বিষয়

• Plugins: Cordova এর API প্লাগইন ব্যবহারের মাধ্যমে অতিরিক্ত ফিচার সাপোর্ট করতে সক্ষম। Cordova এর অফিশিয়াল প্লাগইন স্টোর বা কাস্টম প্লাগইন তৈরি করে আপনি অ্যাপ্লিকেশনের কার্যক্ষমতা বাড়াতে পারেন।
• Permission Handling: কিছু ডিভাইস ফিচার অ্যাক্সেস করার জন্য ব্যবহারকারীর অনুমতি প্রয়োজন হতে পারে (যেমন ক্যামেরা বা লোকেশন)। সেক্ষেত্রে, আপনি permissions চেক এবং রিকোয়েস্ট করতে পারেন।

সারাংশ

Cordova JavaScript API মোবাইল ডিভাইসের হার্ডওয়্যার এবং সফটওয়্যার ফিচারগুলির সাথে ইন্টারঅ্যাকশন করার জন্য শক্তিশালী টুল সরবরাহ করে। এটি ক্যামেরা, GPS, ফাইল সিস্টেম, কন্টাক্টস, অ্যাক্সিলিরোমিটার এবং আরও অনেক ডিভাইস ফিচার অ্যাক্সেস করতে সহায়ক। Cordova এর মাধ্যমে আপনি একাধিক প্ল্যাটফর্মে একই কোডবেস ব্যবহার করে মোবাইল অ্যাপ্লিকেশন তৈরি করতে পারেন, যা ডিভাইসের নেটিভ ফিচারগুলোকে অ্যাক্সেস এবং পরিচালনা করতে সাহায্য করে।